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This manual describes the AdvaInform Calculations software package (referred to hereafter as 
AdvaInform Calculations). It covers all steps from editing the calculation algorithm to 
executing the calculation. 


The AdvaInform Calculations package is an option for the Advant Station 500 Series 
Information Management Station (IMS). To use AdvaInform Calculations, AdvaInform Basic 
Functions software must be installed on your IMS. AdvalInform Basic Functions software is the 
minimum software required for an IMS. 


You can use AdvalInform Calculations to build and execute calculations in the AdvaInform 
environment. It is intended for straightforward calculations, with the focus on volume rather 
than on complexity. AdvaInform Calculations is designed to meet the most common 
requirements for the calculations used, for example, in the process industry. 


The calculation script language features simple, context-free grammar, is compiled and 
principally intended for simple and fast calculations. The four fundamental rules of arithmetic 
plus a number of mathematical functions such as ABS, EXP, SIN, COS and TAN are supported 
as well as flow control, arithmetic and logical expressions. You test the algorithms interactively 
using the built-in test facilities and script print statements. 


One advantage provided by AdvaInform Calculations as compared to ordinary application 
programming is that development time is reduced by services included in the calculation option. 
For example, the application programmer does not have to include software for time scheduling 
of the calculation executions because it is supported by AdvalInform Calculations. 


Another advantage of AdvaInform Calculations is that less training is required. The person 
making the applications does not have to be a skilled programmer. Script language with a 
straightforward syntax is used. It is not necessary for the person making the applications to have 
knowledge of, for example, compiling and linking. 


Input and output to/from the calculations are object data from any Controller (Advant Controller 
or Master Piece), AdvaInform Object Handling, SuperView 900 or from database tables using 
AdvaInform SQL*Connect Server. 


AdvaInform Calculations can be seen as consisting of five parts. One part is for the 
design/editing and testing of the calculations modules. Another part is for configuring instances 
of the module towards any object that is to be used as input/output. The third part is the status 
display which present a list of all calculations instances in the node and their current status and 
execution times. The fourth part is the run-time environment. The last part is the CalcUtil tool 
which performs actions, such as population, towards the Calculation database. 


AdvaInform Calculations users may be process engineers or production planners writing 
calculations for different purposes as well as operators and maintenance staff involved in daily 
operations. Calculations can also be used on the management level. 


Readers of this manual should be familiar with the basic concepts of the ABB process 
automation system with Advant Technology. 
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1.2 Equipment Requirements 


Advalnform Calculations will run on all of the stations within the Advant Station 500 Series 
IMS. The Advant Station 500 Series Stations are HP-UX, RISC-technology-based workstations. 


1.3 How to Use This Book 


1.3.1 Documentation Structure 


This book is organized into chapters and sections as shown in Figure 1-1. 


Chapter 
Configuration 
Introduction Installation es ean Operation Maintenance oo 
uilding 
General. Site Planning Design | Operating Preventive Appendices 
Information Environment Considerations Overview Maintenance 
Index 
Equipment Setup Capacity & Product Hardware 
Requirements Performance Operation Indicators 
Shut-down 

How to Use Procedures Software Operating Error, Warning 
This Book Setup Instructions and Informational 

Start-u Messages 
Poi aunons Procedures Tutorial Run Time on 
Related Environment Fault Finding 
Documentation Product. Application & User Repair 

Verification Procedures 

Release 
History Menus 
Terminology FAQ Bae een Section 
Product 
Overview 


User Interface 


Figure 1-1. Basic Documentation Structure 


Chapter 1, Introduction 


The Introduction gives you basic information about this manual and AdvaInform Calculations. 


Chapter 2, Installation 


This chapter tells you how to install AdvaInform Calculations on different types of platforms. 
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Chapter 3, Configuration and Application Building 


This chapter describes, in a step-by-step manner, how to edit and test calculation modules, how 
to connect calculation input/outputs towards objects in the IMS or other nodes, and finally how 
to schedule and execute the calculations. 


Chapter 4, Operation 


This chapter tells you how to inspect and operate the already configured and scheduled 
calculations, i.e., primarily, how to start and stop a calculation on demand. 


Chapter 5, Maintenance 


This chapter provides information which you may need in situations when something abnormal 
occurs and when something in the system configuration must be changed. 


1.4 Conventions 


Table 1-1 shows the conventions used in this guide: 


Table 1-1. Conventions used in this guide 


Example... Type of information... 


.. refer to the Adva/nform References to other books are written in italics. 
Calculations User’s Guide.. 


enter command cp file .. Italics font used instead of a value or name. 

.. the very first time you .. | Italics font used to emphasize. 

void main() Program code and commands are written in Courier 
font. 

IMS Menu The names of window elements (for example, the title in 


the title bar of a window, the label for a field of a dialog 
box) are written in the same font as where they appear in 


the windows. 
.. the Station menu .. Initial capital letters are used for the name of menus 
listed in the menu bar. 
.. select Editor from the Initial capital letters are used for the name of menu 
Station menu .. items. 
.. select Station - Editor... | Short for select Editor from the Station menu (above). 
.. enter TIC132 into .. In a tutorial, for ex., you may be told to enter a value into 


a field. The value is then written boldfaced. 


Boldface font is also used whenever there is a need to 
point out a certain word or phrase. 
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Other conventions: 


In procedures and tutorials for example, output on the screen is written in Courier font: 


User input is written in boldface: 


TIC132 


1.5 Related Documentation 


Entered value is not valid. 


The value must be 0-30. 


Enter an object name: 


Table 1-2 lists all documentation related to AdvaInform Calculations 


Table 1-2. Related Documentation 


Category 


Title 


Description 


Hardware 


Advant Station 5xx “) Hardware User’s Guide 


Covers the installation and maintenance of the 
hardware for an Advant Station, no matter if it 
is configured as an Information Management 
Station or as an Operator Station. 


Station 


Advant Station 500 Series IMS User’s Guide 


This book describes the Advant Station IMS in 
general. Read this book to find out about the 
functionality, performance and capacity of all 
Advalnform options. 


Software 


Advalnform Basic Functions User’s Guide 


Describes the basic functions that support all 
Advalnform software packages. 


Options 


Advalnform Object Handling User’s Guide 


The configuration and execution environment 
for User Objects. You must have an Object 
Handling option to execute your objects 


Software 


Advalnform User API User’s Guide 


This book describes how to access the Advant 
process objects through a C language 
interface. 


Software 


Advalnform Object Types Reference Manual 


This book provides attribute names for all 
object types supported by IMS. 


(1) 5xx is short for 515, 520 and 530. 
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Table 1-3 lists the major milestones in the development of AdvalInform Calculations: 


Table 1-3. Release History 


Version 


Description 


1.0 


Initial Advalnform Calculations Release for Advant Station 500 Series 


IMS. 


1.4 


In this release the Calculation script is adapted to IMS release 1.1. 


1.2 


In this release the Calculation script is extended with the following 
functions: 


A new tool, CalcUtil, which performed actions such as dump and 
populate towards the Calculations database. 


The parsing of scripts not only parses, it also compiles the script 
if the 

parsing was successful. The execution of this compiled script is 
much faster than the interpretative execution in earlier versions. 


The script language supports a number of new Built In functions. 


1.3 


New 


functions: 


The Calculation Status display supports multiple selection, 
activation and deactivation of instances. 


You can configure a calculation to execute on a second basis 
using the improved execution configuration display. Fastest 
execution is 1 second. 

You can inspect the configuration of calculations using SQL. The 
User’s Guide documents public database views that you can 
use. 


1.4 


Supports HP-UX 10.20 
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1.7 Terminology 
1.7.1 Acronyms Terminology 


IMS 

ES 

OS 

OCS 
OSF/Motif 


1.7.2 Definitions of Terms 


Algorithm 
Calculation Module 


Calculation Instance 


Calculation State 


Configure 


IMS Menu 


Object 


Script Language 
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Information Management Station 
Engineering Station 

Operator Station 

Open Control System 


Standard for display layout in X-Windows. OSF stands for Open 
SystemsFoundation. 


The algorithm is the script code describing the calculations to 
be performed by the calculation module. 


The calculation module consists of the input and output 
variables and the script algorithm. 


A calculation instance is an instance of a calculation module. 
The input/output variables are given constant values or are 
connected to other objects. 


A calculation instance can be in either of two states, Active or 
Inactive. Active means that it is executing and Inactive that it 
is not. 


For the purposes of this manual, configure means to create a 
specific calculation instance from a calculation module. 


The entry menu to IMS. From this menu, all of the installed 
Advalnform and AdvaBuild options can be selected. The 
start-up and usage of the IMS menu is more fully described 
in the Advalnform Basic Functions User’s Guide. 


Objects can be connected to the calculation instances as 
input or output variables in the configuration phase. Any 
available object of an object type with appropriate attributes 
can be used as input. The outputs are restricted to a few 
object types. 


Script language is the language used to describe the 
calculation algorithms. The syntax rules are described in 
Appendix A, Script Language. 
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1.8 Product Overview 


1.8.1 Main Components 


The main components of the AdvaInform Calculations package are: 
° Calculation Builder 

° Calculation Instance Configuration 

° Calculation Status Display 

° Run Time Environment 

° CalcUtil Tool. 


Each of these components are further described in the following sub-chapters. 


1.8.2 Calculation Builder 
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Calculation Builder is an interactive, graphical tool used mainly to define input and output 
variables and to edit the script code describing the algorithms for the calculations. You can also 
use this tool to test the module with user-defined test data as input. 


The first step when you use Calculation Builder is defining the input/output variables of your 
calculation. Next, you will edit your calculation formulas and logics according to the script 
language syntax. 


For the third step, you parse the algorithm in order to detect illegal commands and syntax errors. 
If the parsing was a success the algorithm will automatically be compiled into object code. 

If errors is detected during compilation no object code is generated and a message describing 
the error is presented in the message display. When the script code is error-free, you can verify 
the correctness by entering test values as input and executing the algorithm. By doing this you 
will be able to discover run time errors before creating any instances of the calculation module. 


1-7 


Advalinform® Calculations User’s Guide 


Chapter 1 Introduction 


1.8.3 Calculation Instance Configuration 


1-8 


Calculation Instance Configuration is an interactive dialog used to create specific instances of a 
calculation module. Each instance is connected to a specific set of real objects (in a Controller 
or an IMS) and constants. It is also given a time schedule for execution. An instance has a 
unique name. 


After you have made sure your calculation algorithm works properly, you must connect the 
inputs/outputs to real objects. Use the Calculation Instance Configuration to connect the 
instance you create with real objects and constants. The total number of variables is limited to 
32 for input and 8 for output. The connected input and output variables can be of the following 
types: Floating, Integer long and Boolean. 


Another step you must complete before the calculation can start working is to set up a time 
schedule for its execution. You do this by calling up the scheduling dialog from the Calculation 
Instance Configuration. When you have finished the connection and the time scheduling, 

you can save the module as a calculation instance. Note that the cyclic execution is not active by 
default. 


An alternative way of activating a calculation is by triggering. Digital input (DI) signals can be 
used for that purpose. In that way, the output to a DI from one calculation can be used to trigger 
another one, through that DI. 


Calculation 
instance # 2 


Calculation 


instance # 1 


y 


Figure 1-2. Output to a DI from One Calculation Used to Trigger Another One 


An instance is a fully defined calculation—defined with respect to the calculations to be 
performed, the objects and constants to be used as inputs/outputs and a time schedule, 
or triggering object, for execution. 
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1.8.4 Calculation Status Display 


Group liatty 


Instance State Status Last Execution Next Execution Module 
Fri Jun 14 09:17; Fri Jun 14 09; 


=] 


Active 

Inactive 

Inactive 
CalcTanki_volume Active 
CalcTank2_reset Inactive 
CalcTank2_acc Active 
CalcEngineS_count Active 
CalcTank2_volume Active 
CalcEng5_NoOfStart Inactive 
Test_1 Inactive 


tankvolume 
tankvolume 
tankvolume 
tankvolume 
tankvolume 
tankvolume 
tankvolume 
tankvolume 


ooo qoaoeada ad 


Test_2 Inactive 


| Activate | | Deactivate | 


Figure 1-3. Calculation Status Display 


Calculation Status Display shown in Figure 1-3 presents a list of the calculations in the IMS 
node, their status and times for execution. The list can show either all of the calculation 
instances for a certain group or all of the calculations (for all groups). 


From this display, you can also activate and deactivate selected calculation instances by clicking 
on the Activate and Deactivate buttons (at the bottom of the display). Use the Refresh button to 
update the information on the screen. 


1.8.5 Run Time Environment 


The run time environment refers primarily to the execution of calculations according to the time 
scheduling or triggering specified by the configuration tool or according to commands from the 
Calculation Status display. You never interact directly with the run time environment, but only 
interact using the tools described above. 
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1.8.6 CalcUtil Tool 


1.9 User Interface 


CalcUtil Tool lets you perform a number of actions towards the Calculations database. 
The utility provides services to handle: 


° dump of calculation instances and modules into text files 

° population of calculation instances and modules from text dumps 
° removal of calculation instances and modules 

° list existing modules. 


These actions are described in Appendix C, CalcUtil Commands. 


The user interface is based on the OSF/Motif standard. 


For configuration and to get information about your currently stored data there are two displays 
available to you: 


° For module and instance configuration, the Calculation Builder display 
° For presentation of Calculations instances, the Calculation Status display. 


These two displays can be accessed from the IMS menu bar. How to log in to the IMS menu is 
described in the Advalnform Basic Functions User’s Guide. 


For a detailed description of the Calculation displays and how to use them, please refer to 
Chapter 3, Configuration and Application Building and Chapter 4, Operation in this guide. 


To get access to the CalcUtil tool, an IMS terminal window must be opened. The tool is started 
by typing the command “/products/components/Calculations/bin/CalcUtil”. 


Besides those interfaces, included in IMS, you can use the tools provided by the AdvaInform 
User API, together with for example X-window programming, to build your own interfaces. 
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Chapter 2 Installation 


2.1 Site Planning Environment 


2.2 Setup 


2.2.1 Hardware 


Calculations requires the AdvaInform Basic Function for operation. See the Advant Station 500 
Series IMS User’s Guide for information about site planning, installation, and diagnostics. 
Though it is not required, it is also advantageous to have the AdvaInform Object Handling 
option installed when you use AdvaInform Calculations. With AdvaInform Object Handling 
installed, you can create local instances of the Basic Objects and use them as input/output to 
your calculations. 


For details regarding the hardware, refer to the Advant Station 500 Series IMS User’s Guide and 
the relevant Advant Station 5xx Hardware User’s Guide. 


2.2.2 Software Installation and Removal 


Generally, the AdvaInform Calculation software is loaded onto the Advant Station at the factory 
prior to delivery. Therefore, you generally do not have to load the software. 


If you, for some reason, have to install or remove the Calculation software, refer to the Advant 
Station 500 Series IMS User’s Guide for instructions. 


2.3 Shut-down Procedures 


The AdvaInform Calculations run time environment is automatically stopped when the 
Advant Station 500 IMS is stopped. 


2.4 Start-up Procedures 
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The AdvaInform Calculations run time environment is automatically started as part of the 
Advant Station 500 IMS start-up procedures. 
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The Calculation displays are activated from the IMS menu: 


—| Advant Station 500 IMS a 


File Station AdvaBuild Advalnform AdvaTalk Session Settings Help 
Object Handling = 
Reports > 
Calculations | Calculation Builder 
Calculation Status 


Figure 2-1. Starting the Calculation Builder from the IMS Menu 


2.5 Product Verification 


Select AdvaInform-Calculations from the AdvaInform menu bar and select the Calculation 
Builder. When the Calculation Builder is presented, select Help - On Version. Verify that the 
version corresponds with the delivery information. Exit the Calculation Builder. Start the 
Calculation Status display. Select Help - On Version and verify that you get the same 
information as for the Calculation Builder display. 


To verify that the software is properly installed and running, check the Node Status display. The 
process “Calculation” should be up and running. 
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Chapter 3 Configuration and Application Building 


3.1 Design Considerations 


This section gives you general recommendations and hints to consider before you start building 
applications with AdvaInform Calculations. For example, it is important to look at the other 
tools for application building that are provided by the IMS software. 


Section 3.4, Tutorial provides a tutorial which describes a specific example, including most of 
the features available when you build a calculation module and configure an instance. 

It describes in detail all of the steps required. Section 3.5, Application Procedures provides a 
checklist of the steps involved in building and configuring. 


3.1.1 Chaining of Calculations 


As mentioned in Section 1.8.3, Calculation Instance Configuration, you can activate a 
calculation in two ways: by scheduling and by triggering. Both of the methods can be used at 
the same time for certain calculations. Chaining means that an output to a DI object from one 
calculation can be used to trigger another calculation using that DI as triggered input. 


To use the trigger facility, you must define an input Boolean variable. This variable must also be 
used in the script. 


3.1.2 Connection to Objects 


Also mentioned in Section 1.8.3, Calculation Instance Configuration, any calculation can be 
connected to input and output objects residing in: 


° The same IMS ___ (input data can also be requested from external databases via 
SQL*Connect - Server) 


° Other IMS Stations 
° Controllers (Advant Controller, MasterPiece, SuperView 900). 


A calculation instance can be connected to objects residing in different nodes (stations) at the 
same time. The connections are specified in the configuration display. The objects are referred 
to by their (unique) names. 


There are restrictions on the number of objects connected to each calculation. See Section 3.2, 
Capacity and Performance. 
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3.1.3 Planning Your Calculations 


As the number of calculations might be high, it is recommended that you define some naming 
rules before you start building the calculations. This makes it easier both to use and maintain the 
calculations. 


The first step could be to assign each process area a specific calculation group. Then, assign 
each type of calculation some identification. 


For example, volume calculations for a blow tank: 
° Store all calculation instances for the blow tank in calculation group called blow_tank. 


° Set the name of volume calculations to vol_xxx, where xxx is a running number or 
something similar. 


This is one way to structure your calculations which helps you in maintenance, use and further 
development. Any other method will do as long as it does not conflict with the general naming 
rules. (See Appendix B, Object Name Syntax and Time Abbreviations.) 


3.1.4 Other Tools for Application Building 


AdvaInform Calculations is intended primarily for volume calculations, as mentioned in Section 
1.1, General Information, with a greater focus on volume than complexity. 


For more advanced calculations with requirements exceeding what is provided by Advalnform 
Calculations, it is recommended that you look at AdvaBuild Object Type Builder and 
AdvaInform Object Handling. Object Type Builder lets you build and configure complex object 
types, called User Objects, with a number of built-in features for execution control and C++ as 
the programming language. Object Handling option has services for configuration, creation of 
object instances and execution control. 


If your requirements are very specific, and cannot be met using the tools described above, you 
can use the services provided by the AdvaInform User API (Application Programming 
Interface) software. This software is available in any IMS, regardless of the platform used. 
The AdvaInform User API services are described in greater depth in the Advalnform User API 
User’s Guide 


It is also possible to use the AdvaInform User API services from user objects. That combination 
can solve must application needs. 


Another option is to use the AdvaTalk Link to MATLAB option. MATLAB supports many 
complex algorithms and methods. 


3.1.5 Connections to Other Applications 


Various alternatives for solving your application requirements are discussed above. Of course, 
those tools may also be used in conjunction with one another. For example, an output (digital) 
from a calculation can be used to trigger the execution of a User Object, or an output from a 
calculation can be used for further treatment by an application built using the User API software 
or vice versa. 
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3.2 Capacity and Performance 


See the Advant Station 500 Series User’s Guide for details on Capacity and Performance. 


3.3 Software Setup 


3.4 Tutorial 
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To start the Calculation Builder tool in AdvaInform Calculations from the IMS menu, select 
AdvalInform - Calculations and then, from the pull-down menu, Calculation Builder. 
The Calculation Status display is selected the same way. 


a Advant Station 500 IMS q 


File Station AdvaBuild Advalnform AdvaTalk Session Settings Help 
Object Handling => 
Reports = 
(Calculations —_] +] Calculation Builder 
Calculation Status 


Figure 3-1. Starting the Calculation Builder or the Calculation Status Display 


How to start up the IMS menu is more fully described in the Advalnform Basic Functions 
User’s Guide. 


You can build and configure calculations and access the Calculation Status display from an 
X-terminal connected to an IMS, from the IMS console, from an Operator Station connected 
towards an IMS Station, or from a PC with X emulation. 


This section gives you step-by-step instructions on how to design, test and configure a specific 
calculation. Section 3.6, Menus, describes in detail all the fields in the various displays referred 
to below. 


1. Prepare your calculation. 


Define input and output variables and make a draft for your algorithms. For details, see the 
script language syntax in Section A.1, Syntax. 


2. Log on to the IMS where your calculation is to run. 


3. Start the IMS menu. 
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4. Start the Calculation Builder: 


— Advant Station 500 IMS Q 


File Station AdvaBuild Advalnform AdvaTalk Session Settings Help 
Object Handling => 
Reports > 
Calculations >| Calculation Builder 
Calculation Status 


Figure 3-2. Selecting the Calculation Builder 


To start the Calculation Builder (see Figure 3-2), select Calculations, and then the item 
Calculation Builder from the AdvaInform menu of the IMS menu. 
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Calculation Builder 5 
File Help 


Description: [tank volume calculation 


Variable Name 


Direction 


Input 
Input 


Output 


DataType Test Value 
false 
Float 


Float 
Float 


Calculation Script 


volume_pi*radius*level ; 
dumy=trigger; 


@ Input 
> Output 


© Boolean 


Instances 


[petete | ete 
CNN - TE |, os 


Messages 


Figure 3-3. Calculation Builder 


In this tutorial, we will create the first of a number of calculations for a pulp fiberline: 
The calculation of the volume of a cylindrical buffer. We know the radius of each buffer 
from drawings, and the level of material/liquid in the buffers can be measured. 
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Valve 


Volume 


Level 


Radius 


Figure 3-4. Volume of a Cylindrical Buffer 


The input variables level, radius and pi will be used in the algorithm to create the output 
variable volume. We want to support triggered execution so the input variable trigger will 
also be defined. The execution will be executed every 30 minutes and each time the state of 
the output valve, which opens and closes the output of liquid from the buffer, changes. 


Description: [tank volume calculation | 


Figure 3-5. Module Presentation Window 


5. Select New from the Calculation Builder File menu. 
A New Module dialog box pops up requesting a new module and group name. 


6. Enter the new module name tankvolume and the group name fiberline in the dialog fields. 
Click OK. 


If the new names are accepted, the Calculation Builder creates the new calculation. 
The display is presented with a module and group name according to Figure 3-5. 


7. Enter the description in the description field. 
8. Specify input and output symbols. (See Figure 3-6) 
a. Click on the Clear button. 
This will clear all of the variable connection fields. 
b. Select the variable name field and enter /evel. 


c. The direction is selected by clicking the Input or Output button. Level is an input 
variable and as Input is the default direction, it is already selected. 


d. The data type is selected by clicking the Float, Integer or Boolean button. Level is a 
floating value and as Float is the default data type, it is already selected. 


e. Select the test value field and enter 5.0 as the test value. 


f. | Click Update to store the variable and have it presented in the connection window. 
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g. Repeat Steps b. through f. for the rest of the variables. The result will be as shown in 
Figure 3-6. 


Variable Name Direction DataType Test Value 


Boolean false 
Float 
Float 


Float 
Float 


| ri al ig 
: > Output ¢ Integer 


& Boolean 


Figure 3-6. Input and Output Connection Window 


9. Click in the Calculation Script window and edit your calculation code according to the 
script syntax. The trigger is used only to activate the calculation and is not part of the 
algorithm. The script language, however, requires that all input and output variables are 
used. To circumvent this, enter an assignment which has no meaning. 


Calculation Script Instances 


volume_pi*radius*level ; 
_| dumy=trigger;| 


| Parse | i Test | | Save | 


Figure 3-7. Calculation Script Window 


— Parse and compile by clicking on Parse until no errors remain. 


— Test by clicking on Test, using the specified test data as input. Check the algorithm 
by verifying the resulting output volume. 


When you are satisfied with the result, save the calculation module by clicking on 
Save and continue at Step 10 below. 


10. Enter the Calculation Instance Configuration display (Figure 3-7). 


To do that, click on New to the right of the Instance scroll list. As a result, a pop-up dialog 
will request the name of the new instance. Enter the name, CalcTankI_volume, and click 
on OK. When the name is accepted (the name must be unique and follow the rules 
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described in Appendix B, Object Name Syntax and Time Abbreviations ), the Calculation 


Instance Configuration is activated. 


11. Configure your calculation using the Calculation Instance Configuration display 


(Figure 3-8) 


Calculation Name: | Caictank? volume Execution Config] Status: [Stopped 


Module Name : kankvolume 


Variable Name Direction Object name/Constant value Attribute Name 


Figure 3-8. Calculation Instance Configuration 


For each variable do the following: 


—  Single-click on the variable in the variable list. 


This starts a dialog (Figure 3-9) which will differ depending on the variable type. 


3BSE 002 257R0301 


Level: 


Aavalintorm® Calculations User’s Guide 
Section 3.4 Tutorial 


Variable Name : 


Data Type: 


© ConstantValue 


@ ObjectConnection 


Name : LevelTank_1[ 
Attribute : VALUE 7 


Figure 3-9. Dialog Box for Input Connection (Object) and Attributes Pop-Up List 
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The variable Jevel is connected to the AI object LevelTank_1 with the attribute 
VALUE in this case. Click on Object Connection to open the Name and Attribute 
fields for input. 


Select the Name field. Enter LevelTank_1. 


Now you need to specify which of the LevelTank_1 floating point attributes will be 

used as input. Click in the Attribute field. It is labelled “undefined” until an attribute 
is selected. A list of available attributes pops up. Select VALUE from the Attributes 
pop-up menu (Figure 3-9) and click OK. 


Click on the OK button to close the Input Connection dialog and confirm and save 
the entered information. Name and Attribute selection are presented in the 
connection window of the Calculation Instance Configuration display. 


3-9 


Advalnform® Calculations User’s Guide 
Chapter 3 Configuration and Application Building 


3-10 


Pi: 


Data Type: 


@ ConstantValue 


& ObjectConnection 


Name : 


Attribute + Undefined 


Figure 3-10. Input Connection Dialog (Constant Value) 


Then continue with the constant pi: 


— Constant Value is the default, so you need only enter the constant value of pi = 3.14 
(Figure 3-10). 


— Click on the OK button to confirm and save the entered information. The constant 
value pops up in the connection window of the Calculation Instance Configuration. 


The radius variable is configured in the same way. The radius is 4.2 meters. 


Then connect the trigger object. Do that in the same way as the other connections by first 
selecting the variable trigger from the Calculation Instance Configuration display. This will 
cause the DI Connection display (Figure 3-11) to appear. Then continue as follows: 
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<& Not Connected 


@ Object Connection 


Name : Tank1_output_closed 


& Trigger 


Figure 3-11. DI Connection Dialog 


Click on the Object Connection button. Enter the name of the DI object which will 
trigger the execution in the name field: Tank/_output_closed. 


Click on the Trigger box to turn the trigger flag on. 


| OK | | Cancel | | Help | 


Figure 3-12. Trigger Element Dialog 


Click on the event name field to produce the Event dialog box, featuring a list of all 
available events. Select EVENT. 


Click on the OK button to close the DI Connection dialog and confirm and save the 
entered information. Name and Event selections for the trigger variable pop up in the 
connection window of the Calculation Instance Configuration. 
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Now it’s time to connect the variable volume (Figure 3-12). This is done in the same way as the 
other parameters: 


Data Type : 


Object Name : VolumeTank_1 
[Cancel 


Figure 3-13. Output Object Connection Dialog. 


— Select the name field. Enter the name of the output object (an Analog Input or Analog 
Output): VolumeTank_1. 


— Click on the OK button to close the Output Object Connection dialog and confirm 
and save the entered information. Output Object name pops up in the connection 
window of the Calculation Instance Configuration. 


By now, all of the parameters are configured and it is time to configure the cyclic execution as 
well. This is started from the Calculation Instance Configuration (below). 


Click on Execution Config to the right of the Calculation Name field. This will cause the 
Execution Configuration display to pop up. Continue at the next point. 


Calculation Name: | CaicTanki_volume Execution Contig] Status: [Stopped [Star] 
Stop] 


Module Name : kankvolume 


Variable Name Direction Object name/Constant value Attribute Name 


VolumeTank_1 


Figure 3-14. Calculation Instance Configuration. 
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12. In the Execution Configuration display (Figure 3-15), you can specify when to execute 
your calculation by entering data in the proper fields. The execution can either be cyclic or 
scheduled. By clicking on any of the Modify buttons (to the right of those fields) in the 
scheduled part, you can also enter specific dialogs for specification of months, days, hours, 
minutes and seconds for the time of execution. You specify the execution at specific 
(absolute) times, for example, 12 0’clock on the last day of every month, or minute 0, 5, 
10, 15, 20, 25, 30, 35, 40, 45, 50, 55 every hour to achieve execution every fifth minute. 


Year 


Month 


Day 


Hour 


Minute 


Second 


Interval 


Figure 3-15. Execution Configuration Dialog. 


In this example we want to execute the calculation every half minute. The easiest way to achieve 
this is to click on the Cyclic Execution Enabled button and enter 30 in the Interval field. The 
other way to do it is to use the Scheduled Execution Enabled: 


First, click on the Scheduled Execution Enabled button to enable scheduled execution. The * 
in the Year, Month, Day, Hour and Minute fields means every year, month, day, hour and minute 
respectively, and is set by default. Then click on the Modify button, to the right of the Second 
field, to start the Second Configuration dialog box (Figure 3-16). 
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OK | [Cancel 


Figure 3-16. Second Configuration Dialog. 


Then continue as follows: 


13. 


14. 


15. 


16. 


17. 


3-14 


a. Click on None to clear all minutes. 
b. Click on 0 and 30 to select the time interval. That is every half minute. 
c. Click on OK to close the Second Configuration dialog box. 


d. When finished, click on OK in the Execution Configuration dialog to return to the 
Calculation Instance Configuration. 


Click on Apply to save all the information and to keep the Calculation Instance 
Configuration display open. All inputs and outputs are now checked once more. 


The Status field will not be accessible until the information has been successfully saved. 


Click on Start in the Calculation Instance Configuration display to initiate execution 
according to the specified time schedule. 


Click on Cancel in the Calculation Instance Configuration display to close it and return to 
the Calculation Builder display. 


When you are back in the Calculation Builder display, exit from the Calculation Builder by 
selecting File - Exit. 


Start the Calculation Status Display to verify that the calculation executes according to the 
time schedule you have specified. 
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3.5 Application Procedures 


This section gives you a summary of the various steps to building and configuring your 
calculations. 


1. Plan your calculation structure. 


Start by grouping your calculations logically for your installation. You can also set up 
some naming conventions to make it easier to identify calculation modules designed for 
specific purposes (for example, average calculation) and to identify calculation instances 
to be used, for example, in different process areas. 


2. Write an outline of your calculations and define input and output variables, time 
scheduling and DJ-objects for eventual chaining or triggered execution. 


3. Plan the testing by assigning test input values and evaluating the corresponding output 
values. 


4. Edit and test your calculations using the Calculation Builder tool. 


5. Configure the instances using the Calculation Instance Configuration tool in the 
Calculation Builder. 


For help configuring inputs and outputs, see the Advalnform Object Type Reference 
Manual. 


3.5.1 Authorization 
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Calculation Instance Configuration will always try to open a calculation for read and write 
access. Only one user at a time, however, is granted write access to one individual module or 
instance. The first user to open the calculation module is granted write access. 


A message informs you that the calculation module or instance cannot be modified because 
another user has been given write access to it. Actions that can affect the calculation are not 
allowed and are not accessible (shaded). 


Calculation Instance Configuration can not modify an object which is active. A message will 
inform you that the instance is available for inspection only. Deactivate the instance if you want 
to perform any configuration. 


The configuration display works locally in the node where it is executing. This means that it will 
only be possible to display and configure calculations residing in that node. 
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3.6 Menus 


3.6.1 Calculation Builder Display 


Calculation Builder $ 


‘ 

: Module name: |%é2kvoiume Group Name: |#e>erine 
Description: jtank volume calculation 

‘ 


+” | | Variable Name Direction DataType Test Value 


Input Boolean 
: Input Float 

' Input Float 

F Input Float 

iH Output Float 

' 


> Output ¢ Integer 
© Boolean 
Delete 


a Calculation Script Instances 


wolume=pi*radius*level ; 
dumy=trigger ; 


Delete 


| Parse | Test | | Save | 


ian Messages 


Figure 3-17. Calculation Builder Display. 


Calculation Builder consists of a main window and a number of pop-up windows. The main 


window menu bar features File and Help menus. 
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The main window can be broken down into five areas, as seen in the Figure 3-17. 


1. General information, accessed from the File menu by Open and Nevw, is displayed in this 
presentation area and includes the Module Name, Group Name and Description. 


2. The connection area includes all information needed to identify the variables used in the 
calculation. 


3. The calculation script is edited, parsed and tested in this area. 


4. This area uses the Calculation Instance Configuration to configure and time schedule the 
calculation instances of a calculation module. 


5. The Messages area presents errors, warnings and information detected during usage 
(for example parsing and compiling) of the display. 


A description of the items that can be selected from the File and Help menus follows. 


3.6.1.1 File Menu 


Open 


Save 


Save As 


Delete 


Exit 


Figure 3-18. File Menu. 


You can access the New, Open, Save, Save As, Delete and Exit functions from the File menu. 
Each option is described in detail in the following sections. 
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File-New 


Select New when you want to create a new calculation module. When the previously selected 
module is successfully saved, enter the new module and group name in the New Module dialog 
box. 


Module [ | 


| OK | [Cancel] 


Figure 3-19. Dialog Box to Enter Name of a New Calculation. 


° Module and Group Name: 


Enter the new module and group names in the dialog fields. The names must follow the 
rules described in Appendix B, Object Name Syntax and Time Abbreviations. You can 
also select the group name from the scrolled list of all defined calculation groups with a 
single click. The selected group appears in the text field of the new group name. 

The module name must always be typed in. 


* OK 
Click OK when you have entered a proper name. 
? Cancel 
Click on Cancel to inhibit the New Module dialog request. 
° Help 
Click Help to view Help information about this dialog box in a Help message box. 
. <ENTER> 


Press <ENTER> and the default action is performed. The default action depends on the 
selection made the last time the question was answered. It is marked with a double frame. 
In the figure above, OK is default. 


When you have entered the new names and they have been accepted as legal, the Calculation 
Builder display presents the new module. 
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File-Open 


Select Open from the File menu to fetch an already existing module. 


Modules 


[ALL] 


Module | ankvolume 


| Apply | [Cancel | Help | 


Figure 3-20. Open Module Dialog Box. 


Click on the calculation group you want to select in the left-hand selection box. A list of the 
existing modules of that group appear in a list in the right-hand selection box. If you click on 
ALL, all modules independent of group are presented: 
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Module 
Click on the selected module name in the module name list. 
OK 


Click on the OK button when you have selected the desired module. The selection box 
closes. 


Apply 
Click on the Apply button to select the module in the Module name field while keeping the 
module name box open. You can easily browse between the modules in that way. 


Cancel 
Click on the Cancel button to close the selection box without any further action. 
Help 


Click on the Help button to view Help information about this dialog in a Help message 
box. 


<ENTER> 


Press <ENTER> to perform the default action. The default action depends on the selection 
made the last time the question was answered. It is marked with a double frame. In the 
figure above, OK is the default. 
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File-Save 
Select Save to save the currently selected calculation module. 


If the calculation module is not opened for write access, see Section 3.5.1, Authorization. Save 
will be dimmed in the File menu and cannot be selected. 


Save push button placed below the script text field has the identical functionality of File-Save. 


File-Save As 


Save As lets you copy an existing calculation module. You copy what you see on the screen. 
This means that modifications done since the module was selected will also be saved into the 
new module. 


When you select Save As, the dialog box below will appear on the screen: 


Save As Module 


Groups 


Figure 3-21. Save As Dialog Box to Enter a New Module Name 


NOTE 


File-Save As only copies the module, not the instances. 
Since the instances have unique names, they cannot be copied. 


° Module and Group Names 


Enter the new module and group names in the dialog fields. The names must follow the 
rules described in Appendix B, Object Name Syntax and Time Abbreviations. You can 
also select the group name from the scrolled list of all defined calculation groups with a 
single click. Selected group appears in the text field of the new group name. Module name 
must always be typed in. 
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: OK 
Click on OK when you have entered the group and module names. 
: Cancel 
Click on Cancel to inhibit the Save As request. 
° Help 
Click on Help to view Help information about this dialog box in a Help message box. 
° <ENTER> 


Press <ENTER> to perform the default action. The default action depends on the selection 
made the last time the question was answered. This is marked with a double frame. In the 
figure above, OK is default. 


If the new names are accepted, the new calculation module appears on the screen. It is 
recommended that you at least modify the calculation description before you save it. 


File-Delete 


Delete removes all information about a calculation module. A calculation module can not be 
deleted if any instances of that module exists. 


The delete request must always be confirmed. This is done with a dialog box: 


Confirm Delete 


a Sure You want to delete ? 


Figure 3-22. Delete Confirmation Dialog Box. 


° Yes 
Click on Yes if you really want to delete the module. 
« No 


Click on No if you do not want to delete. 


File-Exit 


Select Exit to leave the Calculation Builder display. 
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3.6.1.2 Help Menu 


Help 


On Windows 
On Keys 
Index 

On Help 

On Version 


Figure 3-23. Help Menu 


Help-On Windows 

Gives you information concerning the current window. 

Help-On Keys 

Gives you information about how to use the various keys on the keyboard. 
Help-Index 


Gives you descriptions of topics related to AdvaInform Calculations. Double-click on a 
presented index to view the Help information for the specific topic you select. 


Help-On Help 
Gives you information about how to use Help. 
Help-On Version 


Gives you information about the version/revision of the current calculation package. 
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3.6.1.3 Calculation Builder Display - Fields and Buttons 


This section describes the fields, windows and buttons available in the Calculation Builder 
display. Figure 3-17 is shown again below to make it easier to follow the descriptions. 


Calculation Builder 6 


File Help 


’ 
: Module name: | fankvoiume Group Name: | #eberine 
‘ 
Description: Jtank volume calculation 
\ 


Variable Name Direction DataType Test Value 


Input Boolean 
Input Float 
Input Float 
Input Float 
Output Float 


: > Output ¢ Integer [Update | 


© Boolean 
Delete | 


Calculation Script Instances . 


wolume=pi*radius* level ; 
dummy=trigger ; 


New 


Modily | 
: Cony] ;. 4 
1 Delete | 


1 
+ : 
| Parse | Test | | Save | ' 


a Messages 


Figure 3-24. Calculation Builder Display. 
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The boxes, buttons and fields in Figure 3-24 are presented from top to bottom. 


Area 1: General Information 


Module Name 

The name of the current calculation module. (Presentation only.) 
Group Name: 

The group name of the current calculation module. (Presentation only.) 
Description 


A description of the current module to help you in identifying the calculation. 
(The description is entered here, max 40 characters.) 


You can access a calculation module from the File menu by Open or New dialog boxes. 


Area 2: Configuration of Calculation Variables 


Variable Name 


A list of one or more variables used as input or output to the calculation. Choose the names 
according to the script language syntax rules (see Section A.1, Syntax). Use the text box 
below the variable list to enter the variable name. 


Direction 
Identifies whether the variable is to be used as input or output. 
— Input, Output 
Use these buttons to specify whether the variable is to be used for input or output. 
Data Type 
Any of the available data types: integer, float or Boolean. 
— Float, Integer, Boolean 
Use these buttons to select the type of input and output. 
Test Value 


A value to use for testing the calculation algorithm. Use the text box below the variable list 
to enter the test value for the selected input variable. The value is checked when you click 
on Update, and is only valid for variables with input direction. 


Clear 
Click on Clear to clear the variable and value fields and prepare for new input. 
Update 


Click on Update to create a new variable or to update the selected variable from the 
Variable list. 


Delete 


Click on Delete to delete the selected variable. 
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Area 3: The Calculation Script 


Calculation Script 


Edit your calculation script here. For details about the script syntax, see Appendix A, 
Script Language. You can use the keyboard mouse to copy script texts from existing text 
files into the script field. 


NOTE 


Output variables can not be assign to another variable. This is because these 
variables assign its value after the script is finished. A way to get around this is to 
connect the same object to both an input and an output variable. The input 
connection can then be used in assignments. 


Parse 


Click Parse to parse and compile the current script code. Errors are reported both on the 
parsing and compiling phase, however no compilation will be performed if the parsing 
fails. 


Test 


Click Test to start execution of the current script code using the test values. Test button is 
not accessible until a successful parsing and compilation is performed. 


Save 


Click on Save to save the current calculation module. Save has the same functionality as 
File-Save. 


The script can be configured although instances exists. To use a new script configuration the 
instances must be stopped and restarted. 


Area 4: The Instance Configuration 
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Instances 


A scroll list showing the existing instances of the current calculation. An instance is a fully 
configured calculation. To select an instance, single-click on the name in the list. 
To cancel the selection, single-click once more. 


New 

Click on New to create a new instance of the current calculation module. 
Modify 

Click on Modify to modify the instance you selected from the Instances list. 
Copy 

Click on Copy to create a copy of the instance you selected in the Instances list. 
Delete 


Click Delete to delete the selected instance. 


NOTE 


The push buttons in Area 4 are not available until a successful parsing and 
compilation of a script followed by a save is done. 


3-25 


Advalnform® Calculations User’s Guide 
Chapter 3 Configuration and Application Building 


Area 5: Messages 
° Messages 


Error, warning and information messages are presented in the Messages list. One example 
of messages are the error messages generated during the parsing phase. 


3.6.2 Calculation Instance Configuration 


Calculation Name: | Caictank? volume Execution Contig] Status: [Stopped 


Module Name : kankvolume 


Variable Name Direction Object name/Constant value Attribute Name 


Figure 3-25. Calculation Instance Configuration. 


Instance Configuration display lets you configure your calculation instances of the calculation 
modules. 


Below are descriptions of all the boxes, buttons and fields which are part of the above display. 
The presentation is made from top to bottom. 


: Calculation Name: 
The name of the instance currently shown. 
° Module Name: 


The name of the module upon which the instance is built. Note that this is not an input 
field. It is the module you selected in the Calculation Builder display. 


° Execution Config 


Click on Execution Config to enter the Execution Configuration dialog box for time 
scheduling of the instance. Do that as the last step in configuration of an instance. You can 
reach Execution Config even if the calculation is started, but it is only configurable if the 
instance is stopped. 


3-26 3BSE 002 257R0301 


Aadvalnform® Calculations User’s Guide 
Section 3.6.2 Calculation Instance Configuration 


Status: 
— Started or stopped 


The status is either started or stopped. You cannot start the calculation until the 
configuration is successfully saved. 


All input and output variables of the selected calculation module are presented in a list. The list 
contains the following columns: 


Variable Name 


The names of the input and output variables. The names are those you specified in the 
Calculation Builder display. 


Direction 


Input or output connection. This information is also fetched from the Calculation Builder 
display. 


Object Name/Constant Value 


Either the name of an object (of any of the supported types) or the numeric value of a 
constant. The text N. C. means that the connection is not yet configured. 


Attribute/Event 

Either the name of an object attribute or an event. 
OK 

Click on OK to save the current configuration data. 
Apply 


Click on the Apply button to save the instance while keeping the Calculation Instance 
Configuration open. 


NOTE 
You must configure all connections before you can save an instance. 


Cancel 
Exit the dialog without saving. 


Help 


Click Help to view Help information about this dialog box in a Help message box. 


To configure a variable, single-click after you select the variable in the Variable list. One of 
three possible configuration dialogs pops up as a result of the single-click: 
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Input connection 
DI connection 


Output Object connection. 


NOTE 


You can modify the configuration only when the calculation is stopped. 
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Data Type: 


@ ObjectConnection 


Name : LevelTank_1[ 
Attribute : I VALUE 


Figure 3-26. Input Connection Dialog Box and Attribute Dialog Box 


An input connection (Figure 3-26) is a connection to any attribute of any object type matching 
the data type. What object instance and what attribute is decided upon at configuration. You can 
alternatively specify a constant value to use as replacement. 
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Variable Name 


The variable name of the selected variable is displayed at the top of the dialog. 
(Presentation only.) 


Data Type 

The connection data type is displayed below the variable name. (Presentation only.) 
Constant Value 

Click on the Constant Value button when you want to enter a constant value. 


Object Connection 


Click on the Object Connection button to enter an object name and a corresponding 
attribute. 


— Name: Enter the name of an existing object and then click on the attribute push 
button. 


— Attribute: A list of attributes matching the connections data type is displayed when 
you click on the Attribute field. If no attribute matches the data type, the object name 
is not accepted. To select the desired attribute, single-click then click on OK. 


OK 

Click on the OK button to confirm and save the information entered on the screen. 
Cancel 

Click on the Cancel button to delete all the information entered since the last OK. 
Help 


Click Help to view Help information about this dialog box in a Help message box. 
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Variable Name : 


& Not Connected 
@ Object Connection 


Name : Tank1_output_closed 


fl Trigger 


| OK | | Cancel | | Help | 


Figure 3-27. DI Connection Dialog Box and Trigger Events Dialog Box. 


A DI connection is a connection to a specified DI object instance. By selecting the trigger 
facility, you can specify that the calculation you configure will be executed when the connected 
DI generates the specified event. 
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Variable Name: 


The variable name of the selected variable is displayed at the top of the dialog. 
(Presentation only.) 


Not Connected: 


The connection is not connected. Click on the Not Connected button and enter a constant 
value of true or false in the input field. 


Object Connection: 
Click on the Object Connection button to enter the object name. 
— Name: Enter the name of an existing DI object. 


— Trigger: Click on the Trigger button to turn the trigger flag on and off. When the 
trigger is activated, the calculation is started when the connected DI object generates 
the specified event; that is, the trigger specifies an event-driven execution of the 
calculation. 


— Event name: The event name is displayed next to the Trigger button if the trigger is 
set to on. Clicking on the event name field produces an Event dialog box featuring a 
list of all available events. Select the desired event with a single click. 


OK 


Click on the OK button to confirm and save. The information is made part of the Instance 
Configuration and is shown in the variable list. 


Cancel 
Click on Cancel to exit the dialog box without any actions. 
Help 


Click Help to view Help information about this dialog box in a Help message box. 
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Variable Name; | volume 
Data Type : 


Object Name : 


Figure 3-28. Output Object Connection Dialog Box. 


Specify the object to which your calculation result will be sent with the Output Object 
Connection. You can configure the floating point outputs to AI and AO objects. The maximum 
number of outputs are two of each type. 


You can configure the integer output connections to DAT objects. DAT objects are objects used 
for data storage. They have no additional functionality. In ABB Master, they are used as “help 
objects” for data storage. DAT objects exist in IMS and in Controllers. Make sure that the DAT 
object has its data type attribute configured to integer long format. 


You can configure the Boolean outputs to a DI and a DO object (one of each). 
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Variable Name: 


The variable name of the selected output variable is displayed at the top of the dialog. 
(Presentation only.) 


Data Type: 
The data type of the configured object is displayed. (Presentation only.) 
Object Name: 


Enter the name of an existing object of the appropriate object type in the Object Name 
field. 


OK 


Click on the OK button to confirm and save. If the object is accepted, the dialog is 
terminated and the configured information is shown in the variable list. 


Cancel 
Click on the Cancel button to terminate the dialog box without saving the changes. 
Help 


Click Help to view Help information about this dialog box in a Help message box. 
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3.6.3 Save Dialog 


If you change or modify a calculation module or an instance and then try to exit a display 
without saving, the following dialog box appears: 


Figure 3-29. Save Dialog Box 


° Yes 
Click Yes to save before continuing. 
« No 
Click No to continue without saving. 
. Cancel 
Click on Cancel to exit the dialog box without any actions. 
° <ENTER> 


Push <ENTER> to perform the default action. The default action, Yes, is marked with a 
double frame (Figure 3-29). 


Examples of situations when the Save dialog appears include when you have changed the 
current (displayed) calculation module or instance and then: 


° Select New or Exit from the File menu. 


° Select another calculation module or instance. 


3.6.4 Execution Configuration 


3.6.4.1 Layout - Execution Configuration Dialog 


Use the configuration display for execution to set up a time schedule for execution of a 
calculation instance. Start it from the Calculation Instance Configuration by pushing the 
Execution Config button. 


Calculation Instance Configuration is locked when the Execution Configuration display is in use 
to prevent other users to configure the instance. 
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The display lets you specify either pure cyclic execution (fixed time between each execution) or 
execution at specific times, for example, 12 o’clock the last day of each month, January to 
October. 


interval 


Figure 3-30. Execution Configuration Dialog 


Scheduled execution. 


Set the instance execution time using the upper part of the Execution Configuration dialog box. 
The specified time interval may be one or several absolute times and gives you full flexibility. 
You can specify a cyclic scheduling from this display and the execution times are aligned to the 
scheduled times. 


In the example in Figure 3-20 the execution takes place during March, April, August and 
November on Mondays through Fridays as well as on the Ist, the 15th and the last day of each 
month specified. 


Execution takes place eight times during each of these days (at 6:15:00, 6:15:30, 7:15:00, 
7:15:30, 14:15:00, 14:15:30, 22:15:00 and 22:15:30). 


Cyclic execution. 


The cyclic interval is specified in seconds. This is a fast and convenient way to configure a 
cyclic execution. You can use it when the repetition interval is important, not execution at 
specific times. The execution is aligned to the last execution time and not to a schedule. 


In the example in Figure 3-31, the object is executed every seventh second from the activation 
time. 
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3.6.4.2 Execution Configuration Dialog - Selections 


Click on OK or Cancel to terminate the Execution Configuration dialog box. Click on OK if 
you want to save the new definition or on Cancel if you do not want to save the new definition. 


The execution method is selected by pressing one of the toggle buttons ‘Scheduled Execution 
Enabled’ or ‘Cyclic Execution Enabled’. One or none of them can be selected. A new object 
does not have any execution mode set as default. 


Year 


Month 


Day 


Hour 


Minute 


Second 


Interval 


Figure 3-31. Cyclic execution selected 


3.6.4.3 Specifying Cyclic Execution 


Cyclic execution is valid if the Cyclic Execution Enabled is set to on. The Interval in seconds 
is entered in the corresponding input field. 


3.6.4.4 Specifying Scheduled Execution 
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The specified execution time(s) is valid only if the Scheduled Execution Enabled field is set to 
on. Click on the Scheduled Execution Enabled button! to turn the execution state on or off. 


Enter all time components either as text strings or in separate pop-up dialog boxes. Use the 
corresponding Modify button (to the right of the field concerned) to start the pop-up dialog 
boxes. 


1. Since setting the scheduled/cyclic execution to off does not affect the of the execution configuration data, it is easy 
to turn the cyclic execution off temporarily and run the object without time execution. 
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Year 


Enter the year in the Year field as a text string. The text string’s legal format is YYYY, e.g., 
1993. * meaning every year, is also a valid input. 


Month 


Use the following text format for Month: 
e Ey 
Use * to specify executing every month. 


> MMM,MMM 


One or several months are specified in a list. See Section B.2, Abbreviations for Months 
for valid abbreviations. 


Example: JAN,NOV 
* MMM-MMM 


A sequence of months are specified. 


Example: JAN-APR 


Day 
Use the following text format for weekdays (Monday - Sunday): 
e Ey 
Use * to specify executing every day. 
« DDD,DDD 


One or several days are specified in a list. See Section B.3, Abbreviations for Weekdays 
for valid abbreviations. 


Example: MON,TUE 
° DDD-DDD 


A sequence of weekdays. 
Example: MON-FRI 


Use the following text format for dates (1-31) of the month: 


e Bo 


Use * to specify executing every day. 
¢ NN,NN 
One or several days of the month (numbers | - 31) are specified in a list. 


Example: 1,5,30 


° NN-NN 
A sequence of days of the month is specified. 
Example: 1-5 

° Last 


Enter Last for the last day of the month. 
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Hour 


Use the following text formats for hours: 


* 

Use * to specify executing every hour. 

HH,HH 

One or several hours (0 - 23) are specified in a list. 
Example: 7,18,23 

HH-HH 

A sequence of hours is specified. 


Example: 7-9 


Minute 


Use the following text format for minutes: 


* 

Use * to specify executing every minute. 

MM,MM 

One or several minutes (0 - 59) are specified in a list. 
Example: 15,30,45 

MM-MM 

A sequence of minutes is specified. 


Example: 0-15 


Second 


Use the following text format for seconds: 


* 

Use * to specify executing every second. 

SS,SS 

One or several seconds (0 - 59) are specified in a list. 
Example: 15,30,45 

SS-SS 

A sequence of seconds is specified. 


Example: 0-15 
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Month Configuration 


S|January ©) July 

Cl) February I August 

I= March ©) September 
I April ©) October 
©) May [= November 
©) June ©) December 


| OK | [Cancel] | Help | 


Figure 3-32. Month Configuration Dialog Box 


Choose the month(s) time component using the Month Configuration dialog box. 


Fields, Push Buttons and Push Keys 
° All 

Click on the All button to select all months. 
° None 


Click on the None button to select no month. Clicking on the None button clears all 
months before you make a single selection. 


° January - December 


Click on the button to the left of each month you wish to select. You can select any 
combination of months. 


. OK 


Click on the OK button to save the Month definition and terminate the Month 
Configuration dialog box. 


° Cancel 


Click on the Cancel button to terminate the Month Configuration dialog box without 
modifying the Month definition. 


° Help 


Click on the Help button to view Help information about this dialog in a Help message 
box. 
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Day Configuration 


Day 
IE Monday Thursday ©) Sunday 


I= Tuesday I Friday 
IE Wednesday ©) Saturday 


All 


Date 


1 
Se 
os 
o4 
os 


All 


Figure 3-33. Day Configuration Dialog Box 


Selecting Days of the Week 


Use the following push buttons in the weekday portion of the dialog box: 
e All 


Click on the All button to select all weekdays. 
« None 


Click on the None button to select no week day is selected. Clicking on None clears all 
weekdays before you make a single selection. 


° Monday - Sunday 


Click on the box to the left of the weekdays you wish to select. 


Selecting Days of the Month 


Use the following push buttons in the day of the month portion of the dialog box: 
* All 


Click on the All button to select all days. 
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None 


Click on the None button to select no day. Clicking on None clears all days before you 
make a single selection. 


1-31 


Click on the box to the left of the number(s) corresponding to the days of the month you 
wish to select. 


Last 


Click on the box to the left of Last to select the last day of the month. 


Common Push Buttons 


You can use the following push buttons from either section of the dialog box: 


OK 
Click on the OK button to save the definition and terminate the dialog box. 
Cancel 


Click on the Cancel button to terminate the dialog box without modifying the definition. 
Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 
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Hour Configuration 


Olis O12 O16 820 
Oe 613 O17 821 
Olio M14 18 M22 


O11 15 Gis Olas 


Figure 3-34. Hour Configuration Dialog Box 


Fields, Push Buttons and Push Keys 
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All 


Click on the All button to select all hours. 


None 


Click on the None button to select no hour. Clicking on None clears all hours before you 
make a single selection. 


0 - 23 
Click on the box to the left of the number corresponding to the hours you wish to select. 


OK 


Click on the OK button to save the definition and terminate the dialog box. 


Cancel 


Click on the Cancel button to terminate the dialog box without modifying the definition. 
Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 
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Minute Configuration 


Figure 3-35. Minute Configuration Dialog Box 


Fields, Push Buttons and Push Keys 


3-40 


All 
Click on the All button to select all minutes. 
None 


Click on the None button to select no minute. Clicking on None clears all minutes before 
you make a single selection. 


0-59 

Click on the box to the left of the number corresponding to the minutes you wish to select. 
OK 

Click on the OK button to save the definition and terminate the dialog box. 

Cancel 

Click on the Cancel button to terminate the dialog box without modifying the definition. 
Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 
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Second Configuration 


Odo S50 
Oa O51 
O42 O52 
O43 O53 
O44 O54 
O45 O55 
O46 O56 


Ola7 £157 
Olas 58 
flag €j59 


Figure 3-36. Seconds Configuration Dialog Box 


Fields, Push Buttons and Push Keys 
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All 
Click on the All button to select all seconds. 
None 


Click on the None button to select no second. Clicking on None clears all seconds before 
you make a single selection. 


0-59 

Click on the box to the left of the number corresponding to the second you wish to select. 
OK 

Click on the OK button to save the definition and terminate the dialog box. 

Cancel 

Click on the Cancel button to terminate the dialog box without modifying the definition. 
Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 
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3.7 FAQ (Frequently Asked Questions) 


Why do not the Calculation script support simple counters of the type Obj=Obj1+1;? 


Create both and input and an output connection to the object and write your counter as: 
ObjOut!=ObjIn1+1; 


Why is the execution time displayed in the Status Display not the time when the Calculation 
objects starts executing but when it starts to read it’s input data prior to the execution? 


No work around exists 
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Chapter 4 Operation 


4.1 Operating Overview 


Normally, calculations execute according to the time schedule specified by the configuration 
data or when triggered by a Digital Input object—directly or in a chain as described in 
Chapter 3, Configuration and Application Building. 


Calculations can be activated manually. This is done from the Calculation Status display shown 
in Figure 4-2. Further on, you can activate a calculation using an AdvaInform User API 
interface from an application program. 


The output from a calculation can be stored in the following object types: 2 AI (Analog Inputs), 
2 AO (Analog Outputs), 1 DI (Digital Input), 1 DO (Digital Output) and 2 DAT (an object type 
useful as place holder for integer data). See Chapter 3, Configuration and Application Building 
for details. 


There are predefined display elements for all of these object types; whether the object instances 
are located in IMS or in a Controller, they can be presented in AdvaCommand displays. They 
can also be logged in a numeric log. 


Since SQL access to instances of these object types is supported, the result can also be presented 
by any tool using SQL as the access method (SQL*Plus, Oracle Forms, AdvaInform Reports, 
Oracle Cards, etc.). 


4.2 Product Operation 


You can operate the Calculation Status display from: 
° an X-terminal connected to an IMS, 

° an operator station connected towards an IMS, 
° the IMS console terminal window, or 


° a PC with X emulation software. 


4.3 Operating Instructions 


4.3.1 General 
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The user interface to present configured calculation instances is the Calculation Status display. 
It gives information about existing calculations and their status. 


Start the Calculation Status display from the IMS menu by selecting AdvaInform - 
Calculations from the menu bar. 
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— Advant Station 500 IMS a 


File Station AdvaBuild Advalnform AdvaTalk Session Settings Help 
Object Handling => 
Reports > 
Calculations | Calculation Builder 
Calculation Status 


Figure 4-1. Selecting the Calculation Status Function. 


4.3.2 Calculation Status Display 


Group [iar 


Instance State Status Last Execution Next Execution 


Active Fri Jun 14 09:17; Fri Jun 14 09; 

Inactive 

Inactive 
CalcTanki_volume Active i viv: i 318; tankvolume 
CalcTank2_reset Inactive tankvolume 
CalcTank2_acc Active 3173 3173 tankvolume 
CalcEngineS_count Active 3173 718; tankvolume 
CalcTank2_volume Active 1173 :1?;3 tankvolume 
CalcEng5S_NoOfStart Inactive tankvolume 
Test_1 Inactive tankvolume 
Test_2 Inactive tankvolume 


| Deactivate SelectAll 


Figure 4-2. Calculation Status Display 


The calculations are presented containing the following fields: 
° Group 

Name of the calculation group. 
° Instance 


Name of the calculation instance. 
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° State 
State field showing whether or not the calculation is Active (started) or Inactive (stopped). 
— Inactive: The calculation is not active, that is, currently not executing. 


— Active: The calculation is active, that is, executes according to its configured 
execution and to trigger and command requests. 


° Status 
Shows the status of the calculation. The status can be: 
- OK: The last execution succeeded without problem. 


— Input Error: One or several of the configured inputs cannot be read. Check the IMS 
System Messages display for more information. 


— Script Error: A fault has occurred in the script execution. 
: Last Execution 


Shows the time of the last execution of the calculation. It is blank if the calculation has 
never been executed or does not have configured execution. 


° Next Execution 
Shows the calculated time for the next execution of the calculation. It is blank if the 


calculation has never been executed or does not have configured execution. 


NOTE 


The times in Last Execution and Next Execution is when the object start to read 
the input connections. The actual execution starts when all inputs are read. This 
might take a few seconds if the system is heavily loaded. 
« Module 
Name of the calculation module. 
° Activate 


Click on Activate to start the selected calculations. This activates the calculations. 
However, they do not execute until they are started by theirs schedule, by a trigger or by a 
command from another object. The presentation of the activated calculations are 
automatically refreshed shortly after the Activate action. 


° Deactivate 


Click on Deactivate to stop the selected calculations. The presentation of the stopped 
calculations are automatically refreshed shortly after the Deactivate action. 


¢ — Select All 
Select all instances of the selected group. 
° Refresh 


Click on Refresh to update all the information on the screen. A cyclic refresh also takes 
place every third minute. 
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4.3.3 File Menu 


4-4 


The calculation instances can be selected in the following ways: 


Single selection 
The mouse button is used to select only one calculation. 
Continuous selection 


Click one the first calculation and hold the mouse button pressed while dragging the mouse 
arrow to another calculation. All calculations between these two will be selected. 


Another way is to click on the first calculation and then hold “SHIFT”. Then click on 
another calculation and all calculations between these two will become selected. 


Discontinuous selection 


Click on the calculations which shall be selected while holding “CTRL” pressed. 


The File menu features two items, the Open and the Exit functions. 


File -Open 
Groups 
Gi 
fieberine 
[ALL] 
Figure 4-3. Group Open Dialog. 
° Groups 


Select the group name from the scrolled list of all defined calculation groups with a single 
click. The selected group name then appears in the Group field of the Calculation Status 
display, and the list of calculations includes the instances of that group. Click on ALL to 
include all instances independent of group. 


OK 


Click OK when you have selected the desired group. All calculation instances of the 
selected group are then displayed in the Calculation Status list. 
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* Cancel 

Click on Cancel to exit the Group Open dialog box without any actions. 
° Help 

Click on Help to view Help information about this dialog box in a Help message box. 
° <ENTER> 


Press <ENTER> to perform the default action. The default action depends on the selection 
made the last time the question was answered. This is marked with a double frame. In the 
figure above, OK is the default action. 


File -Exit 


Exit closes the Calculation Status display window and returns to the previously opened window. 


4.3.4 Help Menu 


Help 


On Windows 
On Keys 
Index 

On Help 

On Version 


Figure 4-4. Help Menu 


Help-On Window 

Gives you information concerning the current window. 

Help-On Keys 

Gives you information about how to use the various keys on the keyboard. 
Help-Index 


Description of topics related to the Calculation Status Display. By double-clicking on a 
presented index, you can view the help for that specific part. 


Help-On Help 
Gives you information about how to use Help. 
Help-On Version 


Gives you information about the version/revision of the current calculation package. 
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4.4 Run Time Environment 


4-6 


Calculation Run Time Environment consists of a process, a so called object handler. The name 
of the process is “calchandler’. Chapter 2, Installation contains information on how to start and 
stop the run time environment. Calculation Instance Configuration and the Calculation Status 
Display interact with the run time environment each time an instance is started or stopped. Each 
calculation instance is an object in IMS. You can interact with the object from any other object 
in the system. Functions such as Activate, Deactivate, execute can be requested. See the Object 
Type Reference Manual for more information about the calculation object type. 
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Chapter 5 Maintenance 


5.1 Preventative Maintenance 


Currently, there are no specific maintenance actions needed for AdvaInform Calculations. 
Please refer to the Advant Station 500 Series IMS User’s Guide for general information about 
maintenance of your IMS system. 


5.2 Hardware Indicators 


Not applicable. 


5.3 Error, Warning and Informational Messages 


5.3.1 Messages from Displays 


Errors detected when you are using the Calculation Builder display, described in Chapter 3, 
Configuration and Application Building, are presented in the message window in the lower part 
of the display. Those messages normally provide all the information necessary so you can take 
appropriate action. 


The Calculation Status display presents error messages in message boxes. 


5.3.2 Messages from the Script Parsing and Execution 
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Error, warning and informational messages may occur when you are parsing, compiling or 
executing calculation modules and instances. In the test phase, for example, when you are using 
the Calculation Builder display, the messages appear in the message window. 


Keys: 

(CONSTRUCT)status detected during object creation 

(PARSE) status detected during parsing 

(LINE) status reports line number 

(POS) status reports line number and character position in line 
ERRORS 

Error 6 Script function %Function% is not implemented for data type. 
Error 7 Script function %Function% is not implemented for data type. 
Error 8 Invalid value for assignment statement in line %Line%. 

Error 9 If condition does not evaluate in line %Line%. 
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Error 10 
Error 11 
Error 14 
Error 15 
Error 16 
Error 17 
Error 38 
Error 61 
Error 62 


Error 63 
Error 64 


Error 65 
Error 66 
Error 67 


Error 68 


Error 70 
Error 80 
Error 81 
Error 82 
Error 83 
Error 86 
Error 90 
Error 100 
Error 101 
Error 102 
Error 104 
Error -1 


Error 123 


Unable to evaluate expression for print statement in line %Line%. 

While condition does not evaluate in line %Line%. 

Parsing error for script in line %Line% at character %Char%. 

Nothing to execute for script. 

Unexpected return from script execution. 

Error return from script execution. 

Variable % VarName% is undefined. 

Unable to evaluate expression for Built-in function %BuiltIn% in line %Line%. 


Built-in function %BuiltIn% argument type is wrong, must be Integer in line 
%Line%. 


Built-in function %BuiltIn% argument must not be negative in line %Line%. 


Built-in function %BuiltIn% argument must be between -1 and | inclusive in 
line %Line%. 


Built-in function %BuiltIn% argument is out of range in line %Line%. 
Built-in function %BuiltIn% denominator must not be zero in line %Line%. 


Built-in function %BuiltIn% argument must be greater than zero in line 
%Line%. 


Built-in function %BuiltIn% argument type is wrong, must be Integer or Float 
in line %Line%. 


Unable to execute script. 

No operator cube entry for % Variable% in line %Line%. 
No operator cube entry for % Variable% in line %Line%. 
Compare for % Variable% failed in line %Line%. 
%Variable% is NULL in line %Line%. 

Illegal instruction% Variable% in line %Line%. 
%Variable% could not cast in line %Line%. 

Parsing error for script in line %Line% at character %Char%. 
Output variable % Variable% for ImsCalc is undefined. 
Input variable %Variable% is written. 

Output variable % Variable% is not written. 

Unknown error, warning or information. 


Appears in ImsLocation.C 
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WARNINGS 

Warning 69 Inconsistent indices. Indices may not be data type %Variable%, must be String. 
Warning 103 Input variable % Variable% is not read. 

Warning 107 ~—‘- Variable % Variable% is both input and output. 

Warning 108 = Variable % Variable% is specified as an input variable multiple times. 

Warning 109 ~—- Variable % Variable% is specified as an output variable multiple times. 


Warning 110 ~—- Variable % Variable% is not specified as an input or output variable. 


INFORMATIONALS 
Info 105 No input variables specified for script. 
Info 106 No output variables specified for script. 


5.4 Fault Finding and User Repair 


5.4.1 Calculation Configuration and Calculation Menu 
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If any error occurs when you are using the Calculation Builder or Instance Configuration dialog, 
check Chapter 3, Configuration and Application Building to verify that the displays have been 
properly used. 


If you do not find the problem yourself, consult your system manager to find out whether there 
is any problem with your installed software. 


If you still cannot find the problem, please report the error to ABB according to the Advant 
Station 500 Series IMS User’s Guide. 
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5.4.2 Run Time Errors 


Run time errors occur primarily when a calculation runs according to the time schedule set at 
configuration (or triggered) or when started from the Calculation Status display. 


Errors from the calculation run time environment are reported as system messages. The Advant 
Station 500 Series IMS User’s Guide provides information about how to view messages in the 
System Messages display. 


The messages are given in the format: 


Error string <P1><P2><P3> 
Parameters: Pldescription of parameter 1 


P2description of parameter 2 
P3description of parameter 3 


The parameters are optional in a message. This means that there might be no 
parameter, just a text, or from one to three parameters. 


Audience: The audience of the message. Valid entries are Operator and Engineer. 
Cause: Cause of the message. 
Action: Action to take when the message occurs. 


The messages are sorted by severity in the following classes: 
° Fatal error messages 

° Error messages 

¢ Warning messages 

° Information messages. 


A listing follows of the AdvaInform Calculation package messages with a description about the 
reason and recommended actions. These messages are reported from the calculation run time 
environment, a process called calchandler. The calculation run time environment is built using 
User Objects. This means that each calculation instance is an object. When the messages below 
refers to objects, you should read it as calculation instances. 
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5.4.2.1 Fatal Error Messages 


Configuration error: Bad object reference 
Cause: The connected object does not exist any more. 


Action: Reconfigure the connection to a valid object. 


Object error: Operation exception ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 


Cause: A run time error in the object execution occurred, for example, divide by zero. 
The object status bit error is set and the object is stopped. 


Action: The calculation must be reconfigured to run again. Probably you have a logical 
error in the calculation script causing divide with zero or integer overflow to 
occur. Correct the script and start the calculation again. 


Object Error: Instance table error ‘&object.name 


Parameters: P1: Name of object for which the error occurred. 


Audience: Service 
Cause: Error when accessing the instance table. This error should not occur. 
Action: Try to start the object once more. If the error still occurs, contact ABB. 


Object error: OMF bind error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal core system error, can affect future execution. 


Action: Contact ABB. 


Object error: Reduce group error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal core system error, can affect future execution. 


Action: Contact ABB. 
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5.4.2.2 Non Fatal Error Messages 
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General Errors 
Connection error: Bad object reference ‘&connection.name &reference 
Parameters: P1: Name of object for which the error occurred. 

P2: Reference of object for which the error occurred. 
Cause: The connected object does not exist any more. 


Action: Reconfigure the connection to a valid object. 


Error: No more free memory 


Cause: No more free memory in the machine, no more room to create new calculations. 


Action: Delete a few calculations handled by that Object Handler. Extend the UNIX 
kernel to accommodate larger programs 


Object error: Connection read error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: The connected object does not exist any more. 


Action: Reconfigure the connection to a valid object. 


Object error: Cyclic Normal Operation error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: The cyclic operation resulted in a fatal error. 


Action: Check for additional messages for more information on the fault. Reconfigure 
the object if that corrects the error. There may be errors in the object 
implementation as well. 


Object error: Cyclic overflow error ‘&object.name 


Parameters: P1: Name of object for which the error occurred. 


Cause: Cyclic normal operation overflow error. This means that the execution is not 
started in the requested time which is probably due to too much load in your 
IMS. 

Action: Reconfigure the execution schedule. Raising the Object Handler priority (use 


the Object Type Builder) or lowering the priority of other programs may also 
solve the problem. 
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Object error: Trigged Normal Operation error ‘&object.name 


Parameters: P1: Name of object for which the error occurred. 


Cause: A triggered (event-driven) execution of the Normal Operation resulted in a 
fatal error. 
Action: Check for additional messages for more information on the fault. Reconfigure 


the object if that corrects the error. Contact ABB. 


Table Space is full 
Cause: No more free disk memory in the AdvaInform Calculations Oracle disk file 
Action: Contact your system manager. He needs to extend the available table space by 


using the Oracle DBA command Alter Tablespace. He is recommended to adda 
file of 5 MB to the table space IMS_CALCULATE. The disk file shall be 
placed under: 


/disk1/products/data/standard/Calculations/oracle/ 


Internal Software Errors 
Error: Object state processing 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the whole IMS Station. Report the error to ABB. 


Lower level error: & Object name 


Parameters: P1: Name of connection/attribute for which the error occurred. 


Cause: This error log is logged together with another log that describes the error more 
thoroughly. 
Action: Look for another error log issued at the same time and take appropriate actions 


according to that. 


Object error: OMF unbind error ‘&object.name and deactivate the object 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the whole IMS Station. Report the error to ABB. 


Object error: OMF view creation error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the whole IMS Station. Report the error to ABB. 
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Property error: Lost reference’ &property.name 
Parameters: P1: Name of connection/attribute for which the error occurred. 
Audience: Service 


Cause: Internal software error which should not occur. The object is stopped. The 


message is combined with another error message. 


Action: Restart the whole IMS Station. Report the error to ABB. 
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Appendix A Script Language 


A.1 Syntax 


Basic Attributes 


The AdvaInform Calculations script language features simple, context-free grammar. The syn- 
tax is “C-like” or “English-like,” according to your preference, as can be seen in the sample 
script below. 


Sample script in “C-like” syntax: 


// Sample script to compute factorials of 1 to 10 
i= 1; 
fact = 1; 
while ( i <= 10 ) 
fact = fact * i; 
print i, " factorial is ", fact; 
i=i+ 1; 


endwhile; 


Sample script in “English-like” syntax: 


// Sample script to compute factorials of 1 to 10 
put 1 into i; 
put 1 into fact; 
while (iis less than or equal to 10 ) 
put fact * i into fact; 
print i, " factorial is ", fact; 
put i+ 1 into i; 


endwhile; 


Case Insensitivity 


With the exception of literal strings, the entire AdvaInform Calculations script language is case 
insensitive. You can specify reserved words using any mixture of upper and lower case. 
For example, an “if” statement may start with any of the following: IF if, If, iF. 
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Reserved Words 


The following is a comprehensive list of reserved words within the script language: 


ABS ACOS ADD AND ASIN 
ATAN ATAN2 BY CONTINUE COS 
COSH DIV DIVR DO DUMP 
ELSE ELSEIF ENDIF ENDWHILE EQU 
EQUALS EXIT EXP FALSE GT 
GTE IF IN INTO ISNOTNULL 
ISNULL LOG LOG10 LT LTE 
MULTIPLY NEQ NOT OR PRINT 
PUT RAND RETURN SIN SINH 
SQRT SRAND TAN TANH THE 
THEN TO TRUE WHILE 


These words are all reserved and cannot be used for any other purpose within a script. Reserved 
words are case-insensitive, for example, TRUE and true mean the same thing. 


Literals 


The script language supports the definition of string, integer, float and Boolean literals. A literal 
may be used as a constant value in any script language expression. 


String 
String literals are defined by including them in quotation marks. 


"My_Literal" is an example of a string literal. 


Integer 


Any sequence of digits which does not contain the decimal (period) character is defined to be an 
integer literal. All integer literals are considered to be decimal numbers (i.e., base 10). 


1223 is an example of a number literal. 


Float 


Any sequence of digits which contains the decimal (period) character is defined to be a float lit- 
eral. All float literals are considered to be decimal numbers (i.e., base 10). 


1223.34 is an example of a float literal. 
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Boolean 


The character strings true and false are defined to be Boolean literals. These are reserved char- 
acter strings, and they are case-insensitive. 


True, TRUE, true, False, FALSE and false are examples of Boolean literals. 


Variable Names 


Names can consist of the ASCII characters (A-Z and a-z), the ASCII digits (0-9), the underscore 
character (_) and the period (.). Variable names may contain no more than two periods. The first 
character in a variable name must be an ASCII character (A-Z and a-z) or an underscore charac- 
ter (_). 


Variable names are case-sensitive. 
Variable names can be one to 20 characters long. 


My_variable, My. Variable and My. Variable_10 are examples of valid variable names. 


Expressions 


Expressions are comprised of operators and operands. Operands can be literals, variables and 
other expressions. Two built-in functions can also be used as operands in Boolean expressions. 
Valid operators for arithmetic expressions are: 


+, -, *,/,% 

Valid operators for Boolean expressions are: 

OR, AND, EQU, NEQ, LT, LTE, GT, GTE, NOT 
Valid operators for unary operands are: 

+,- 


Operands and operators may be grouped into expressions using parentheses. The script lan- 
guage places no limit on the depth of nesting for parentheses. 


Statements 
The script language includes statements for basic flow control, math, assignments and printing. 


All statements are terminated by a semicolon (;). 
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Assignment 


Assignment statements can be in the following forms: 


variable_name 
variable_name 
variable_name 
variable_name 
variable_name 


variable_name 


PUT expression IN variable_name; 
ADD expression TO variable_name; 


MULTIPLY variable_name BY expression; 


= expression; 
+= expression; 
-= expression; 
*= expression; 


/= expression; 


oe 
ll 


See Section A.3, Examples for examples of how to use these assignments. 


Flow Control 


Flow control statements can be in the following forms (items contained within square brackets 


[] are optional): 
IF expression 


THEN 


statement list 


[ELSE 


statement list 


fl 


NDIF; 


IF (expression 


statement list 


[ELSE 


statement list 


fl 


NDIF; 


IF expression 


THEN 


statement list 


THEN 


statement list 


ELSEIF expression 
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[ELSE 


ENDIF; 


statement list]] 


IF (expression) 


statement 


statement 


[ELSE 


statement 


n 


Fl 


NDWHILE; 


list 
[ELSEIF (expression) 


list 


list]] 
WHILE expression 
D 


tatement list 


WHILE (expression ) 


statement list 


eal 
Zz 


DWHILE; 


CONTINU! 


Gl 


The CONTINUE statement is of the form: 


CONTINUE; 


The CONTINUE statement causes a jump to the ENDWHILE statement in a WHILE loop. 


EXIT 


EXIT; 


The EXIT statement exits from a while loop; 


RETURN 


The EXIT statement is of the form: 


The RETURN statement is of the form: 


RETURN; 


The RETURN statement causes an exit from the script. 
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Print 
The PRINT statement is of the form: 
PRINT expression list; 


When you perform a test execution of a calculation script in the Calculation Builder, the print- 
outs are presented in the Message list preceded by a text “Print ::” 


The printouts are disregarded in run-time. The printouts are not presented anywhere. 
The script language includes twenty-one built-in functions. These functions are of the form: 


ABS (expr) expr must be number or float. Invokes C function labs() or fabs(). Returns 
number or float. 


ACOS (expr) expr must be number or float, -1.0 <= x <= 1.0. Invokes C function acos(). 
Returns float. 


ASIN (expr) — expr must be number or float, -1.0 <= x <= 1.0. Invokes C function asin(Q). 
Returns float. 


ATAN (expr) expr must be number or float. Invokes C function atan(). Returns float. 


ATAN2 (expr, expr)expr's each must be number or float. Invokes C function atan2(). Returns 
float. 


COS (expr) expr must be number or float. Invokes C function cos(). Returns float. 
COSH (expr) expr must be number or float. Invokes C function cosh(). Returns float. 


DIV (expr, expr)expr's must be numbers. Second expression must not be zero. Invokes C 
function Idiv(). Returns quotient as number. 


DIVR (expr, expr)expr's must be numbers. Second expression must not be zero. Invokes C 
function Idiv(). Returns remainder as number. 


EXP (expr) expr must be number or float. Invokes C function exp(). Returns float. 
ISNULL (expr) returns boolean, TRUE if expr is null, else FALSE; 

ISNOTNULL (expr)returns boolean, TRUE if expr is not null, else FALSE; 

LOG (expr) expr must be number or float, 0 < x. Invokes C function log(). Returns float. 
LOGI1O0 (expr) expr must be number or float, 0 < x. Invokes C function log10Q. Returns float. 
RAND 0) no arguments. Invokes C function rand(). Returns number. 

SIN (expr) expr must be number or float. Invokes C function sin(). Returns float. 

SINH (expr) — expr must be number or float. Invokes C function sinh(). Returns float. 
SRAND (expr) expr must be number. Invokes C function srand(). No return. 

SQRT (expr) expr must be number or float. Invokes C function sqrt(). Returns float. 

TAN (expr) expr must be number or float. Invokes C function tan(). Returns float. 


TANH (expr) expr must be number or float. Invokes C function tanh(). Returns float. 
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Comments 


The script language supports line comments and block comments. 


Line 
A comment can be placed on any line by starting the comment with // characters. 


My_data = 123; //This is an expression followed by a comment 


Block 


A block comment can be placed within sets of /* */ characters. Note that block comments can 
not be nested. 


/* 
This is an example of a block comment preceding an expression. 
*/; 


My_Data = 123; 


A.2 Data Type Conversions 
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Automatic data type conversion is performed by operators in AdvaInform Calculations script 
expressions according to the following rules: 


Arithmetic operations 
(Addition, Subtraction, Multiplication, Division, Percent, Unary Minus): 


° Integers and floats can be mixed freely. You can combine them in all the arithmetic opera- 
tions. Example: You can add an integer and a float number into a resulting float or integer. 


° In general, Booleans and strings cannot be used in arithmetic expressions. 


Comparison operations 
Automatic data type conversions (via conversion operations) are done per the following: 
° When the operands are of the same data type no conversions take place. 


° Number operand towards Number / Float/ Boolean => Number op Number. That is, the 
second operand is converted before the comparison. 


° Float operand towards Float / Number / Boolean => Float op Float. That is, the second 
operand is converted before the comparison. 


° String op String / Float / Number / Boolean => String op String. That is, the second oper- 
and is converted before the comparison. 
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A.3 Examples 


Example 1: Expressions 


// Example that shows how to make logical choices 


// and how to write arithmetic operations 


0)) then 


Gl 


if ((a LTE 0) and (b LT! 


x =a / SQRT(a*a + b*b*2); 


endif; 


Example 2: Assignments 


The following example shows you how to use the different assignments that exist: 


// Example that shows the usage of +=, -=, *=, /=, %= 
// 

// += outfloat=outfloattinfloat+5; 

// 


outfloat=1.0; 


out float+=infloat+5; 

print “+=outfloat=”", outfloat; 
// 
// -= outfloat=outfloat-—(infloat+4); 
out float-=infloat+4; 
print “-=outfloat=”,outfloat; 
// 
// *= outfloat=outfloat* (infloat+1.0) 


outfloat*=infloat+1.0; 

print “*= outfloat=”, outfloat; 
// 
// outfloat=outfloat/ (infloat+3); 


out float/=infloat+3; 

print “/=outfloat=”",outfloat; 
// 

// outfloat=outfloat/100.0; 
outfloat%=; 

print “outfloat%=”",outfloat; 
// 
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The test execution of the AdvaInform Calculations script results in the following printouts with 
infloat set to 1.0: 


Print :: +=outfloat= 7 
Print :: -=outfloat= 2 
Print :: *=outfloat= 4 
Print :: /=outfloat= 1 
Print :: outfloat%= 0.01 


Example 3: Using Local Variables 


You can use local variables freely. They are always assumed to be strings. If, however, the 
expression they are using requires that they be interpreted as another data type, an automatic 
data conversion takes place as described in Section A.2, Data Type Conversions. 


// Calculate output.var = input.var **5 

// Use local variable counter 

// 

counter=1; 

output.var=input.var; 

while (counter < 5) do 
output.var=output.var*input.var; 
counter=countertl; 
print output.var; 


endWhile; 


Alternatively, you can use the “C-like” assignments: 


// Calculate output.var = input.var **5 


// Use local variable counter 
// 
counter=1; 
output .var=input.var; 
while (counter < 5) do 
output .var*=input.var; 
countert=1; 
print output.var; 


endWhile; 
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With input.var = 2 the execution results in the following printouts: 


Prant: 224 
Print :: 8 
Print :: 16 
PYAint 2.2 32 


Example 4: Automatic Data Conversion 

// Store the largest value into outFloat 

// Inputs are integer and a float 

// 

if inInteger > inFloat then 
outFloat=inInteger; 


else 


outFloat=inFloat; 


endif; 
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A.4 BNF Grammar 


This following is the BNF grammar for the AdvaInform Calculations script language. All valid 
scripts can be defined by this grammar. 


program : stmtlist 
| error EOI 
stmtlist : stmt 


stmtlist stmt 


stmt ‘ assignstmt 
commandstmt 
ifstmt 
jumpstmt 
whilestmt 

*{’? stmtlist ’}’ 


9 
? 


assignstmt : Ival =’ expr ’’ 

PUT expr IN lval ’ 

ADD expr TO lval ’’ 
MULTIPLY lval BY expr ’;’ 
Ival ADDSET expr *;’ 

Ival SUBSET expr *’ 

Ival MULSET expr ’;’ 

lval DIVSET expr ’;’ 

lval PERSET ’;’ 
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commandstmt: 


ifstmt 


elseiflist 


ifbody 


jumpstmt 


whilestmt 
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DUMP ’ 
PRINT exprlist ’’ 
SRAND °C expr ?)’’;’ 


IF ifbody ENDIF 


ELSEIF ifbody 
ELSE stmtlist 


’C expr ’)’ stmtlist 

’C expr ’)’ stmtlist elseiflist 
‘C lexpr ’)’ stmtlist 

’C lexpr ’)’ stmtlist elseiflist 
expr THEN stmtlist 


expr THEN stmtlist elseiflist 


CONTINUE ’ 
EXIT ’’ 
RETURN ” 


WHILE ’( expr ’)’ stmtlist ENDWHILE 
WHILE ’( lexpr ’)’ stmtlist ENDWHILE 
WHILE expr DO stmtlist ENDWHILE 
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expr 


builtin 
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expr’) 

expr ‘+’ expr 

expr -’ expr 

expr“? expr 

expr 7’ expr 

expr OR expr 

expr AND expr 

expr EQU expr 

expr NEQ expr 

expr LT expr 

expr LTE expr 

expr GT expr 

expr GTE expr 

expr %’ 

NOT expr 

“expr prec UMINUS 
expr Yprec UMINUS 
lexpr 

constant 


builtin 


ISNOTNULL ’ expr ’)’ 
ISNULL ’( expr ’)’ 
SQRT ’( expr ’)’ 

ABS ’( expr ’)’ 

ACOS ’( expr ’)’ 

ASIN ’( expr ’)’ 

ATAN ‘ expr ’)’ 
ATAN2 ’ expr ’,’ expr ’)’ 
COS °C expr ’)’ 

COSH ’( expr ’)’ 

DIV ’( expr ’, expr ’)’ 
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DIVR (expr ’,’ expr ’)’ 
EXP ° expr ’)’ 

LOG expr ’)’ 
LOG10 ’( expr ’)’ 
RAND 7’)’ 

SIN ’( expr ’)’ 

SINH ’( expr ’)’ 

TAN expr’) 

TANH ’( expr ’?)’ 


lexpr : ‘Clexpr ’) 

| Ival 
Ival : IDENTIFIER 

constant : INTEGER 

| REAL 

| STRING 

| BOOL 
exprlist : expr 


exprlist ’,’ expr 
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Appendix B Object Name Syntax and Time Abbreviations 


B.1 Object Name Syntax 


An object name may consist of up to 20 characters. All characters in the eight-bit ASCII interna- 
tional character set (ISO Latin 1) are allowed, except for the following reserved characters: 


! 


? 


*and % 
All of these characters are reserved for use by ABB. 


The following characters are supported in object names: 


Table B-1. Legal Characters in Object Names 


Hexadecimal Values Characters 
2D - (minus) 
30-39 0-9 
41-5A A-Z 
CO-DF A-B 
5F _ (underscore 
61-7A a-z 
E1-FF a-y 
. (dot) 


B.2 Abbreviations for Months 


The months are abbreviated as follows: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, 
OCT, NOV, DEC 


B.3 Abbreviations for Weekdays 
The weekdays are abbreviated as follows: MON, TUE, WED, THU, FRI, SAT, SUN, LAST 
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Appendix C CalcUtil Commands 


C.1 Introduction 


C.1.1 Service Summary 


CalcUtil provides a number of basic services for the Calculation database. The utility provides 
services to handle: 


° dump of calculation instances and modules into text files 
° population of calculation instances and modules from text dumps 
° removal of calculation instances and modules 


° list existing modules. 


CAUTION 


Population and removal of calculation instances and modules 
(popCALC and rmCALC commands) are off-line commands. 
You must stop the IMS before executing those commands. 


C.1.2 Service Description 


C.1.2.1 Introduction 
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Calculation instances and modules can be described in a source code format. The source code can 
either be generated automatically from existing instances or modules, or manually created in a 
text editor. 


The procedure to use the CalcUtil services is described below. An example of the source code is 
provided. 
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C.1.2.2 Dump and load of object instances 


Table C-1. Dump commands 


Commands Description 
dumpCALCmod <modulename> <file> Dump Calc module definition to file 
dumpCALCmod -all <file> Dump all Calc module definitions to file 
dumpCALCinst <modulename> <file> Dump a specific modules Calc instances to file 
dumpCALCinst -all <file> Dump all Calc instances to file 
dumpCALC <modulename> <file> Dump Calc module and its instances to file 
dumpCALC -all <file> Dump all Calc modules and instances to file 

Example 


$CalcUtil dumpCalc Modulel /tmp/dumpfile.dmp 
Table C-2. Load command 


Commands Description 


popCALC <file> Load Calc modules and instances from file 


Example 


$CalcUtil popCalc /tmp/dumpfile.dmp 


C.1.2.3 Removal of modules and instances 


Table C-3. Delete commands 


Commands Description 
rmCALCmodule <modulename> Remove a specific module from the database 
rmCALCmodule -all Remove all modules from the database 
rmCALC <instancename> Remove a specific instance from the database 
rmCALC -module <modulename> Remove all instances of a specific module from 

the database 
rmCALC -all Remove all instances from the database 
Example 


$CalcUtil rmCalcmodule Modulel 
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C.1.2.4 List existing modules 


Table C-4. List command 


Commands Description 


IsCALCmodules 


List the defined Calc modules 


C.1.2.5 Validation checks 


During the loading of source code the following checks are made: 
¢ Check that the object names are legal. 
¢ Check that attribute values are within the specified ranges or sets. 


¢ Check that constant values given to single connections values are within the specified ranges 
or sets. 


e If the parse flag in the module is true then the script part is compiled. If the compilation was 
a success the objectcode is saved in the database. 


C.1.2.6 Manual creation of source file 
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You should use an existing source code file instead of creating a new one. If you want to create 
a large number of objects, the most convenient method is to dump one object and then use the 
editor’s cut and paste methods to create copies of it. You have to change at least the object name 
and connections to other objects, but many attribute defaults can be the same. An example is 
provided in Section C.1.2.8 Example of a Calculation Source code dump. 
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C.1.2.7 Syntax description 


C-4 


Description of module syntax: 


calc_spec: 
calc_groups_definition: 


calc_groups: 


calc_group: 


calc_modules_definition: 
calc_modules: 


calc_module: 


calc_module_variables: 


calc_variables: 


calc_variable: 


calc_groups_definition 

/* Empty */ 

calc_groups 

calc_group 

| calc_groups calc_group 
CALC_GROUP NAME 
calc_modules_ definition 
CALC_END_GROUP 

/* Empty */ 

calc_modules 

calc_module 

| calc_modules calc_module 
CALC_MODULE NAME 
CALC_OWNER NAME 
CALC_DESCRIPTION DATA 
CALC_MODIFIER NAME 
CALC_CREATION_DATE DATA 
CALC_MODIFIED_DATE DATA 
CALC_SCRIPT DATA 
CALC_PARSED DATA 

/* Empty */ 

CALC_VARIABLES 
calc_variables CALC_END_VARIABLES 
calc_variable 

| calc_variables calc_variable 
NAME CALC_DIRECTION CALC_DATATTYPE DATA 
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Table C-5. Description of different module components 


Identifier name Explanation Values 

CalcGroup Identifies which group the module belongs | A CalcGroup name may be up to 20 characters. 
to. The attribute is only used to sort similar | See Appendix B, Object Name Syntax and 
modules in the same group. Time Abbreviations for reserved characters. 

CalcModule Module name. Unigely identifies the A CalcModule name may be up to 20 
module. Must be unique in the IMS characters. See Appendix B, Object Name 
system. Syntax and Time Abbreviations for reserved 

characters. 

CalcOwner For future use. 

CalcDescription Description of the CalcModule. A CalcDescription may be up to 40 characters. 

See Appendix B, Object Name Syntax and 
Time Abbreviations for reserved characters. 

CalcModifier For future use. 

CalcCreationDate For future use. 

CalcModifiedDate For future use. 

CalcScript The CalcScript contain the script which is | The script may be up to 65000 characters. 
used by the calculation instances to The script syntax is described in Appendix A, 
perform the calculation. Script Language. 

CalcParsed If this flag is true the script is also True or False. 
compiled and saved in the database (if no 
errors occurred during the compilation). 

CalcVariables All configured variables with the following 
syntax: 
name direction datatype testvalue 

name Variable name. Must be unique in the A variable name may be up to 20 characters. 
module. See Appendix B, Object Name Syntax and 
Time Abbreviations for reserved characters. 
direction | Variable direction Input or Output 
datatype | Variable datatype Float, Integer or Boolean 
testvalue | Optional testvalue Value according to the datatype 
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Description of instance syntax: 
dump_spec: 
dumpSpecDefinition: 
objectTypesDefinition: 
object_types: 

object_type: 

objectsDefinition: 


objects: 


object: 
execParams: 


execParams_vl: 


terminalsDefinition: 
terminals: 


terminal: 
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dumpSpecDefinition 

START objectTypesDefinition END 
/* Empty */ 

object_types 

object_type 

| object_types object_type 
OBJECT_TYPE NAME 
/* Empty */ 
| 

objects 

object 
| objects object 
OBJECT NAME 

execParams terminalsDefinition 
END_OBJECT 
execParams_vl 
| execParams_v1 ORACLE_SHADOW DATA 
START_TIME DATA 
NO_OF_REPEATS DATA 
INTERVAL DATA 
NORMAL_OPERATION DATA 
/* Empty */ 
| terminals 

terminal 
| terminals terminal 
ATTRIBUTE NAME DATA 
| SINGLE_CONN NAME 
CONN_TYPE DATA 
CONSTANT_VALUE DATA 
CONN_OBJECT DATA 
ATTRIBUTE DATA 
SUPPRESS DATA 
OPTIONAL DATA 
OPTIONAL_USED DATA 
END_SINGLE_CONN 
| OBJECT_CONN NAME 
CONN_OBJECT DATA 
SUPPRESS DATA 
OPTIONAL DATA 
OPTIONAL_USED DATA 
TRIGGER DATA 
EVENT_NAME DATA 
END_OBJECT_CONN 
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Table C-6. Description of the different components 


Identifier name Explanation Values 

ObjectType Object type name. Identifies the object An object type name may be up to 20 

type that the object definition that follows | characters. It must start with a letter. 
belongs to. 

Object Object name. Uniquely identifies the An object name may be up to 20 characters. See 

object. Must be unique in the IMS system. | the Appendix B, Object Name Syntax and Time 

It is recommended, but not checked, that it | Abbreviations for reserved characters. 

is unique in the whole system. 

StartTime A text string that describes the execution of | When you define this text string, consider the 

the object instances. following: 
A “%” character in the beginning of the text 
means that no cyclic or scheduled execution 
shall take place. 
“%*” is default if no pre-defined execution 
shall be defined. 
Use the Calculation Instance Configuration 
display to configure the requested scheduling 
and then view the resulting text string in the text 
field or dump the resulting instance to a text 
file. 

NoOfRepeats Not relevant 

Interval Not relevant 

NormalOp Calculation consist of | normal operation. | 1. 

OracleShadow If OracleShadow is active, all attribute Active = ‘Y’ 

updates are automatically updated inthe | Not active = ‘N’ 
IMS database as soon as any change Default = “Y’ 
occurs. 
AttributeName Identifies the attribute that the attribute An attribute name may be up to 20 characters. It 
value shall be given to. must start with a letter. See the Appendix B, 
Object Name Syntax and Time Abbreviations 
for reserved characters. 

AttributeData Attribute value Depends on the attribute data type. Values are 
checked towards defined ranges, sets and data 
formats. 

SingleConn Identifies the single connection A connection name may be up to 20 characters. 
It must start with a letter. See the Appendix B, 
Object Name Syntax and Time Abbreviations 
for reserved characters. 
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Table C-6. Description of the different components (Continued) 


Identifier name 


Explanation 


Values 


ConnType 


Single connection type 


“object” = connected to an object 
“constant” = a constant value is configured 


“none” = not configured 


ConstantValue 


Constant value 


Depends on the attribute data type. Values are 
checked towards defined ranges, sets and data 
formats. 


ConnObject 


Name of connected object. 


See object above. Must be the name of an 
existing object. (Checked when the object is 
started.) 


Attribute 


Name of attribute of connected object. 


See attribute name above. The attribute name 
must exist for that object type. 


Suppress, 
Optional, 
OptionalUsed 


Active=’ Y’ 
Not active=’N’ 
Default=’N’ 


ObjectConn 


Identifies the object connection 


A connection name may be up to 20 characters. 
It must start with a letter. See the Appendix B, 
Object Name Syntax and Time Abbreviations 
for reserved characters. 


EventName 


Name of event of connected object. 

If trigger is active, this event will be 
requested for and activate the object on 
event. 


An event name may be up to 20 characters. 
The event name must exist for that object type. 
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The following example shows the source code of a calculation module without any instances. 


// 

// Created by CalcUtil version 1.0-0 

// Fri Sep 1 13:56:09 1995 

// 

CalcGroup PTT 

CalcModule PTTCalcFull5 

CalcOwner imsmgr 
CalcDescription “Average adj 4 values’ 
CalcModifier imsmgr 
CalcCreationDate ‘1995-04-06’ 
CalcModifiedDate ‘1995-04-06’ 


CalcScript ‘FloatResult=(FloatIn1+FloatIn2+FloatIn3+FloatIn4/4); 


if FloatResult < 80 then 
FloatResult=FloatResult+20; 
else 
FloatResult=FloatResult- 100; 
endif; 
Print “Test”; 
CalcParsed ‘true’ 
CalcVariables 
FloatIn1 Input Float 1 
FloatIn2 Input Float 2 
FloatIn3 Input Float 3 
FloatIn4 Input Float 4 
FloatResult Output Float 
endCalcVariables 
endCalcModule 
endCalcGroup 


CalcInstances 
endCalcInstances 


To see the source code of a Calculation instance you can create a dummy instance in the 
Calculation Builder and use the dumpCalcinst command. This will dump the source code to a 
text file which can be viewed in an ordinary text editor. 


NOTE 


The only place where double quotes can be used in the source dump is after a 
Print statement in the CalcScript part. 
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C.2 Starting CalcUtil 


The CalcUtil is an interactive tool. You activate it in an IMS terminal window via the following 
command: 


$/opt/advant/Calculation/bin/CalcUtil 
This activates CalcUtil witch prompts it as follows 


CalcUtil vx.y> 
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Appendix D Views towards Configuration Data 


D.1 


Introduction 


The configuration data of the Calculations instances are easily accessible via a predefined 
database View. The view is accessible from all IMS users. 


D.1.1 CALCOBJECTS View 


The CALCOBJECTS view contains the configuration data of the object’s connections. 


D.1.2 Example 
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Table D-1. The CALCOBJECTS view 


Column Name DataType Description 

OBJECT_NAME VARCHAR (20) - 

VARIABLE VARCHAR (20) - 

DIRECTION VARCHAR (10) - 

CONNECTED_TO VARCHAR (20) The connected object, or 
constant value. 

ATTRIBUTE VARCHAR (20) The connected attribute 
(Relevant for Single 
Connection) 

TRIGG VARCHAR (1) Triggered connection(Y/N) 


SQL> select VARIABLE, DIRECTION, CONNECTED_TO, ATTRIBUTE,TRIGG from CALCOBJECTS where 
object_name = MEANCALC4_IMS44_ 107; 


VARIABLE DIRECTION 
INBOOL1 Input 
INFLOAT1 Input 
INFLOAT2 Input 
INFLOAT3 Input 
INFLOAT4 Input 
OUTBOOLI1 Output 
OUTFLOATI1 Output 


7 rows selected. 


SQL> exit; 


CONNECTED_TO 


DI_IMS44_ 110 
AIC26_25 
AIC26_25 
AIC26_25 
AIC26_25 
DI_IMS44_ 110 
AO_IMS44_110 


ATTRIBUTE T 
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A 
Activation 

By schedule 3-1 

By triggering 1-8, 3-1, 3-11 
Adva Inform User API 1-10 
AdvaBuild Object Type Builder 3-2 
AdvalInform Basic Software 1-1 
AdvaInform Object Handling 2-1, 3-2 
AdvaInform Object Type Reference Manual 3-15 
AdvaInform User API 3-2 
Advant Station 500 IMS User’s Guide 5-1 
Advant Station 500 Series IMS User’s Guide 2-1 
Advant Station 500 Series User’s Guide 3-3 
Authorization 3-15 


B 
BNF grammar A-11 


C 
Calculation 
Last Run 4-3 
Next Run 4-3 
State 4-3 
Status 4-3 
Calculation Builder 1-7, 3-23 
Calculation Instance 1-6 
Start 3-14 
Stop 3-14 
Calculation Instance Configuration 1-8, 3-8, 3-26 
Calculation Module 1-6 
Calculation State 1-6 
Calculation Status Display 1-9, 4-2 
Help Menu 4-5 
CalcUtil 1-10, C-1 
Chaining of calculations 1-8, 3-1 
Connecting input and output 3-1 
Connections to Other Applications 3-2 
Controller 1-1, 3-1, 3-30, 4-1 


D 

Day 3-34 

Delete 
Of instance 3-25 
Of module 3-21 
Of variable 3-24 
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INDEX 


E 
Execution Configuration Display 3-13 
Modify 3-13 


F 
File Menu 3-17 
Delete 3-21 
Exit 3-21 

New 3-6, 3-18 
Open 3-19, 4-4 
Save 3-20 
Save As 3-20 


H 
Help Menu 3-22, 4-5 
Index 3-22 
On Help 3-22 
On Keys 3-22 
On Version 2-2, 3-22 
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